Major-player behavior indicator

Description

Returns featured indicator data for BTC or ETH that reflects how major-player activity may influence price trends within a specific time range.

Use cases:

• Reference for judging the broad price trend of BTC and ETH
• Identify how major-player behavior affects price and assess overall price direction

Data refresh: Updated every 5 minutes

Endpoint

• Method: POST
• Path: /open/v1/indicator/getPriceMarketList

Points

• Points per call: 2

Prerequisites

Obtaining vsTokenId

Condition	Description	How to obtain
Already have vsTokenId	Use the cached vsTokenId directly; no need to query again	Extracted automatically from context
Do not have vsTokenId	Call POST /vs-token/list	Prerequisite API call

Request parameters

Parameters are sent in the request body as JSON.

Parameter	Type	Required	Description
vsTokenId	long	Yes	Token ID
startTime	long	No	Start time (millisecond timestamp)
endTime	long	Yes	End time (millisecond timestamp)

Response fields

Field structure for each object in the data array only:

Field	Type	Actual serialized type	Description
vsTokenId	long	string	Token ID
symbol	string	string	Token symbol
date	long	long	Time (millisecond timestamp)
priceMarketType	integer	integer	Price trend (1: up, 2: down)

Field semantics

Field	Business meaning	Usage suggestion
priceMarketType	Price trend marker	1 indicates an uptrend phase, 2 indicates a downtrend phase; use to judge current price movement

Enum reference

priceMarketType — price trend

Value	Meaning
1	Up
2	Down

Request example

{
    "vsTokenId": 1,           // Token ID
    "startTime": 1770825600000, // Start time (timestamp)
    "endTime": 1773417600000    // End time (timestamp)
}

cURL example (Linux/macOS)

curl --location --request POST 'http://${host}/api/open/v1/indicator/getPriceMarketList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 1,
    "startTime": 1770825600000,
    "endTime": 1773417600000
}'

cURL example (Windows CMD)

curl --location --request POST "http://${host}/api/open/v1/indicator/getPriceMarketList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 1,    \"startTime\": 1770825600000,    \"endTime\": 1773417600000}"

Sample success response

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "vsTokenId": "1",                     // Token ID
            "symbol": "BTC",                      // Token symbol
            "date": 1773158400000,                // Time
            "priceMarketType": 1                   // Price trend (1: up, 2: down)
        },
        {
            "vsTokenId": "1",
            "symbol": "BTC",
            "date": 1773149400000,
            "priceMarketType": 1
        },
        {
            "vsTokenId": "1",
            "symbol": "BTC",
            "date": 1773149100000,
            "priceMarketType": 1
        }
        // ... more items omitted
    ],
    "requestId": "xxx-xxx-xxx"
}